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PREFACE 



These 6500/1 Emulator Specifics are a supplement to the 8002A System User's Manual. 
Insert this supplement into your 8002A System User's Manual, at the end of Section 9, 
Emulator Specifics. 

You may want to note in your table of contents for Section 9 that the 6500/1 Emulator 
Specifics begin on page 9-234. 
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6500/1 EMULATOR SPECIFICS 

This subsection explains the features of the 8002A system that are unique to the 6500/1 
emulator. The 6500/1 Demonstration Run is designed to be used with Section 1, the 
Learning Guide of this manual; the rest of this subsection contains reference material. 



Demonstration Run 

Introduction 

This Demonstration Run shows you how to assemble, load, execute, and monitor the 
execution of a simple program. Designed to be used with the Learning Guide's 
Demonstration Run, this demonstration uses a 8002A system configured with a 6500/1 
emulator. (The Learning Guide's Demonstration Run uses a 8002A system configured with 
an 8080A emulator.) This demontration uses the following conventions: 

1 . Underlined — Any underlined characters in a command line must be entered from your 
system terminal. Those characters not underlined are system output. 

2. All addresses are in hexadecimal notation unless otherwise specified. 

3. <CR> — Command lines are terminated by a carriage return unless otherwise noted. 
When a carriage return is to be entered, the symbol <CR> is used. 

4. <LF> — When a linefeed is to be entered, the symbol <LF> is used. 

Please note: Your 6500/1 displays may differ from the ones shown in this demonstration. 
However, the differences, if any, will be minor. They should not affect your grasp of the basic 
concepts presented here. 



Starting the 8002A System 

Verify that your system is turned on and ready to use. Refer to the Learning Guide 
Demonstration Run for instructions. 
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Look at Your Master Disc; Make a Backup Disc 

(Make sure your system disc is in drive 0.) List the contents of your master disc with the 

ivjiiuvviiiy i_u/ni isim ii i ten m iiiic 

> LDIR <CR> 



disc drive 

6500/1 TEKD0S V3.X 
FILE NAME BLKS 



TEKD0S 

C0PYSYS 
NEWDISC 
DEMONS 



16 

173 

1 

1 

1 



file names and the number of 
blocks each file occupies 



TOTAL FILES 5 
TOTAL BLOCKS USED 192 
BLOCKS AVAILABLE 112 
TOTAL BAD BLOCKS 0- 



"BAD" means blocks not usable 
by TEKDOS 



You may want to make a copy of your master disc before you start using your 8002A, in case 
you accidently erase something on your master disc. Insert a blank disc in drive 1 , then enter 
the following command line to format and verify the new disc, and copy the files from your 
master disc to your backup disc: 



> NEWDISC 



<CR> 



* NEWDISC--F0RMATS, 
FORMAT 1 
•FORMAT* E0J 
VERIFY 1 
•VERIFY* E0J 



VERIFIES, 
format blank disc 

verify new disc 



AND CREATES A NEW SYSTEM DISC 



C0PYSYS 1 



execute COPYSYS command 
file: copy TEKDOS from 
disc in drive to disc 
in drive 1 



* COPYSYS FOR TEKDOS V3-X 

COPY TEKDOS/0 TEKD0S/1 \ TEKD0S 

•COPY* E0J ) 

COPY /0 /1 1 copy control files 

*C0PY* E0J J 

COPY COPYSYS/0 C0PYSYS/1 I copy command file "COPYSYS" 

*C0PY* E0J J 

REN 1 6500 TEKDOS V3.X i name new disc 

•RENAME* E0J / 

COPYSYS COMPLETED 
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Enter the following LDIR command line to confirm that the contents of your system disc in 
drive have been copied to the disc in drive 1: 

> LDIR 1 <CR> 

6500/1 TEKDOS V3.X 

FILE NAME BLKS 

TEKDOS 16 

173 

COPYSYS 1 

NEWDISC 1 

TOTAL FILES 4 

TOTAL BLOCKS USED 191 
BLOCKS AVAILABLE 113 
TOTAL BAD BLOCKS 



Examine the Demonstration Run Program 

The Demonstration Run Program. List the contents of the system disc in drive again with 
the following command line: 

> LDIR <CR> 

6500/1 TEKDOS V3-X 
FILE NAME BLKS 



TEKDOS 


16 


. 


173 


COPYSYS 


1 


NEWDISC 


1 


DEM0%S 


1 ,— 



Demonstration Run program 
source code file 



TOTAL FILES 5 

TOTAL BLOCKS USED 192 
BLOCKS AVAILABLE 112 
TOTAL BAD BLOCKS 



Enter the following command line to copy the source code file from the disc in drive to the 
disc in drive 1 : 
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Enter the following command line to copy the source code file DEMO%S onto the system 
terminal (TEKDOS assumes the file is to be copied to the system terminal when no device or 
other fiie is specified): 

> COPY DEMONS <CR> 



file to be copied 


TITLE 


"6500/1 


ORG 


800H 


DEMO LDX 


#0 


LDA 


#0 


LDY 


#5 


LOOP CLC 




ADC 


500H,X 


INX 




DEY 




BNE 


LOOP 


STA 


04F7H 


NOP 




ORG 


40H 


WORD 


420H 


BYTE 


1AH 


END 


DEMO 


*COPY* EOJ 





DEMONSTRATION RUN PROGRAM" 
START AT ADDRESS 800 
INITIALIZE TABLE POINTER 
CLEAR ACCUMULATOR 
SET PASS COUNTER 
CLEAR CARRY BIT 
ADD BYTE FROM TABLE 
POINT TO NEXT BYTE 
DECREMENT PASS COUNTER 
IF NOT 5 PASSES, LOOP 
IF 5 PASSES, EXIT 
FROM USER PROGRAM 
SET UP SERVICE CALL 
TELLING TEKDOS TO 
EXIT FROM USER PROGRAM 
END OF SOURCE FILE CODE 



Explanation of Demonstration Run Program Source Code. The source code in the file 
DEMO%S contains two kinds of statements: TEKDOS Assembler directives and 6500/1 
assembly language instructions. The assembler directives allow the TEKDOS Assembler to 
convert source code into executable machine language code (object code). The assembler 
directives are explained in the Learning Guide section of this manual. 

The following paragraphs discuss the 6500/1 instructions that constitute the 6500/1 
Demonstration Run program. For more information about the 6500/1 instruction set and 
addressing modes, refer to the 6500/1 Assembler Specifics section of the 8002A Assembler 
Manual. 

What the Demonstration Run Program Does. The Demonstration Run program adds five 
numbers from a table in program memory and leaves the sum in the accumulator. The 
program's steps are illustrated in the flowchart in Fig. 1-5, in the Learning Guide section of 
this manual. 

Prepare Registers. The LDX #0 and LDA #0 instructions clear the X register and the 
accumulator. The LDY #5 instruction sets up the Y register for use as a pass counter. The 
CLC instruction clears the carry bit in preparation for the ADC (add with carry) instruction. 

Add Byte from Table. The ADC 500H,X instruction adds the byte at location 500H, indexed 
by the X register, to the contents of the accumulator. 
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Point to New Byte. The INX instruction increments the X register, which then points to the 
next byte in the table. 

Reduce Pass Counter. The DEY instruction decrements the Y register. Notice that since the 
DEY instruction occurs just after the ADC instruction, the pass counter is decremented after 
each addition is performed. 

Pass Counter=0? The BNE instruction checks to see if the Y register is zero. If the Y register 
does not contain zero, then the program returns to LOOP and adds another number into the 
accumulator. The instructions between CLC and BNE constitute the loop in this program. 
Since the Y register originally held the number 5, the instructions within the loop will be 
executed five times. 

Exit. When the pass counter reaches zero, the program does not jump in response to the 
BNE instruction, but instead proceeds to the STA 04F7H and NOP instructions. These 
instructions are used by the 8002A /^Processor Lab to exit from the user program. (The exit is 
a service call. See Section 6 of this manual for a full explanation of service calls.) 



Run the Demonstration Run Program 

Assemble the Source Code. Enter the following command line to assemble the source code 
and store the assembler output in an object file and a list file: 

> ASM DEM0;0 DEM0;A DEMONS <CR> 

source code file 
assembler list file 
object code file 



Tektronix 6500 ASM V3.X 
«*«» Pass 2 

16 Source Lines 16 Assembled Lines 47047 Bytes available 
>>> No assembly errors detected <<< 
•ASM* E0J 
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The files generated by the above ASM command should now be on the system disc. Enter the 
following command line to list the directory of the disc in drive (the system disc): 
> LDIR <CR> 

6500/1 TEKDOS V3-X 
FILE NAME BLKS 



TEKDOS 


16 


. 


173 


COPYSYS 


1 


NEWDISC 


1 


DEM0;0 


1 


DEM0;A 


2 


DEMONS 


1 



TOTAL FILES 7 
TOTAL BLOCKS USED 195 
BLOCKS AVAILABLE 109 
TOTAL BAD BLOCKS 



Enter the following command line to copy the assembled listing onto the line printer: 

> COPY DEM0;A LPT1 <CR> 

device to be copied to 
(line printer) 

file to be copied 
(assembler list file) 

This command line produces an assembler listing on the line printer. Refer to the Learning 
Guide, Section 1 of this manual, Fig. 1-6, for an explanation of the assembler list format. 



Load the Program into Memory 
• "Zero-out" memory. 

> FILL 800 8FF_00 <CR> 

I 

data 
upper address 
lower address 
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Check that memory was filled with zeros. 

> DUMP 800 8FF <CR> 



upper address 
lower address 



0800=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0810=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0820=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0830=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0840=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0850=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0860=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

0870=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

08A0=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

08B0=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

08C0=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

08D0=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

08E0=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

08F0=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 



address of first 
byte in block 



values of bytes 
in block 



ASCII characters 
corresponding to 
data 



Load the object code file into memory. 

> LOAD DEM0;0 <CR> 

object code file 



TRANSFER ADDRESS: 0800 
*L0AD« EOJ 
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Check memory contents again. 

> DUMP 800 8FF <CR> 



0800=A2 


00 
EA 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


A9 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 

nn 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


A0 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


05 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


E8 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


7D 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


05 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


E8 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


88 
00 
00 
00 

on 
uu 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


DO 
00 
00 
00 

r\r\ 

uu 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


F9 
00 
00 
00 

r\r\ 
\JU 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


8D 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


F7 
00 
00 
00 

/-in 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 
y v 




0810=04 




0820=00 




0830=00 




0840=00 




0850=00 




0860=00 




0870=00 




0880=00 




0890=00 




08A0=00 




08B0=00 




0800=00 




08D0=00 




08E0=00 




08F0=00 




— . — \ 


y 


address of first 
byte in block 










I 


values of bytes 
n block 










I 

ASCII characters 
corresponding to 
data 



• Dump to a line printer. 

> DUMP 800 8FF LPT1 <CR> 



DUMP display device 
(line printer) 



upper address 
lower address 



0800=A2 


00 
EA 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


A9 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 

00 
00 


A0 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


05 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 
c\r\ 

\J\J 

00 
00 


18 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 
nn 

\J\J 

00 
00 


7D 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 
nr\ 

00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 

nn 

00 
00 


05 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 

r\n 

00 
00 


E8 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


88 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 

r\r\ 

uu 

00 
00 


DO 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


F9 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 

rvn 

00 
00 


8D 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 

nn 
\J\J 

00 
00 


F7 


0810=04 


00 


0820=00 


00 


0830=00 


00 


0840=00 


00 


0850=00 


00 


0860=00 


00 


0870=00 


00 


0880=00 


00 


0890=00 


00 


08A0=00 


00 


08B0=00 


00 


08C0=00 


00 


nfinn.nn 


nrv 


08E0=00 


00 


08F0=00 


00 
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• Invoke the Debug system. 

> DEBUG <CR> 

Disassemble object code. 

> DISM 800 811 <CR> 



upper address 
lower address 



LOC INST MNEM OPER 
0800 A200 LDX #00 
0802 A900 LDA #00 
0804 A005 LDY #05 

0806 18 CLC 

0807 7D0005 ADC 0500, X 
080A E8 INX 

080B 88 DEY 
080C D0F8 BNE F8 
080E 8DF704 STA 04F7 
0811 EA NOP 



Execute the Program. 

• Choose the emulation mode. 

> EMULATE <CR> 

I 

emulation mode 

•EMULATE* E0J 

• Set values to the table in memory. 

> EXAM 500 <CR> 

address 

0500=00-01 20-02 20-OJ 20-04 20-05 20 <CR> 



When 0500=00 appears, type 0102030405. 
The system fills in the rest. 
The second carriage return 
terminates the EXAM command. 
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• Set a breakpoint to suspend execution after the last addition. 

> BKPT 504 R <CR> 



"Read" parameter 
address 



• Start program execution. 

> GO 800 <CR> 



L0C INST MNEM 0PER X/Y I/PC EADD SR RA RX RY SP TC IOS 
0807 7D0005 ADC 0500, X 04 0504 24 OF 04 01 10 21AD 80 
0807 BREAK ~T 

I 

RA=contents of the 
accumulator 



In the above BKPT display line, notice that the accumulator contains the hexadecimal sum of 
the numbers in the memory table: 1 +2 + 3 + 4 + 5 = OF. 

You have successfully assembled, loaded, and executed the Demonstration Run program. 
Next you will use some system commands to monitor the program's execution. 
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Monitor Program Execution. 

The following command lines let you monitor program execution. As the program proceeds, 
you can watch the changes in the emulator's registers, and observe the effect of each 
instruction. 

• Trace all instructions. 

> TRACE ALL <CR> 

> GO 800 <CR> 



LOC 


INST 


MNEM 


0PER 


X/Y 


I/PC 


EADD 


SR 


RA 


RX RY 


SP 


TC 


IOS 


0800 


A200 


LDX 


#00 








26 


OF 


00 01 


10 


43CC 


80 


0802 


A900 


LDA 


#00 








26 


00 


00 01 


10 


1C9E 


80 


0804 


A005 


LDY 


#05 








24 


00 


00 05 


10 


3EBC 


80 


0806 


18 


CLC 










24 


00 


00 05 


10 


178E 


80 


0807 


7D0005 


ADC 


0500, X 


00 




0500 


24 


01 


00 05 


10 


39AD 


80 


080A 


E8 


INX 










24 


01 


01 05 


10 


127F 


80 


080B 


88 


DEY 










24 


01 


01 04 


10 


349D 


80 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


01 


01 04 


10 


0D6E 


80 


0806 


18 


CLC 










24 


01 


01 04 


10 


3497 


80 


0807 


7D0005 


ADC 


0500.X 


01 




0501 


24 


03 


01 04 


10 


2F8C 


80 


080A 


E8 


INX 










24 


03 


02 04 


10 


085D 


80 


080B 


88 


DEY 










24 


03 


02 03 


10 


2A7C 


80 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


03 


02 03 


10 


034E 


80 


0806 


18 


CLC 










24 


03 


02 03 


10 


9366 


80 


0807 


7D0005 


ADC 


0500.X 


02 




0502 


24 


06 


02 03 


10 


256D 


80 


080A 


E8 


INX 










24 


06 


03 03 


10 


478C 


80 


080B 


88 


DEY 










24 


06 


03 02 


10 


205D 


80 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


06 


03 02 


10 


427C 


80 


0806 


18 


CLC 










24 


06 


03 02 


10 


5638 


80 


0807 


7D0005 


ADC 


0500.X 


03 




0503 


24 


0A 


03 02 


10 


1B4E 


80 


080A 


E8 


INX 










24 


OA 


04 02 


10 


3D6D 


80 


080B 


88 


DEY 










24 


OA 


04 01 


10 


163F 


80 


LOC 


INST 


MNEM 


0PER 


X/Y 


I/PC 


EADD 


SR 


RA 


RX RY 


SP 


TC 


IOS 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


OA 


04 01 


10 


385D 


80 


0806 


18 


CLC 










24 


OA 


04 01 


10 


2678 


80 


0807 


7D0005 


ADC 


0500.X 


04 




0504 


24 


OF 


04 01 


10 


112E 


80 


0807 


BREAK 




















the contents o 








f 




breakpoint 
notice 


















the Y register, 
the pass counter 
























the contents of 


























the X register. 


























the table pointer 




















i 


he 


c 


ontents of 






















l 


he 


a 


ccumulator 
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Press the space bar if you want to suspend the display and program execution. Press the 
space bar a second time to resume the display and program execution. 

After the accumulator is cleared, the program begins adding numbers and storing the result 
in the accumulator. At the end of the program, the accumulator holds the sum of the 
numbers we put into the table, or 1 + 2 + 3 + 4 + 5 = OF. 

The Y register is used as a pass counter, and is set to contain 5 at the beginning of the 
program. It decreases by one (because of the DEY instruction) each time a number is added 
into the accumulator. The program ends after the Y register reaches zero. 

Notice that the operand field of the ADC instruction contains 0500,X. This is an indexed 
address, and is defined by adding 500 to the contents of the X register. Since the X register 
initially contains zero, the first number added into the accumulator is located at address 500. 
The X register increases by one (because of the INX instruction) each time a number is added 
to the accumulator. 

• Trace Jump instructions only. 

> TRACE JMP, ,806 80C <CR> 



upper 
address 

lower address 



Within this 
range, only 
Jump instructions 
are traced 



pair of commas means that 
the STEP parameter is ignored 



• Check the status of the trace. 

> TRACE <CR> 

TRACE ALL,, 0000, FFFF 
TRACE JMP, ,0806,080C 



> GO 


800 


<CR> 


























L0C 


INST 


MNEM 


0PER 


X/Y 


I/PC 


EADD 


SR 


RA 


RX 


RY 


SP 


TC 


I0S 




0800 


A200 


LDX 


#00 








26 


OF 


00 


01 


10 


334D 


80' 


TRACE ALL 


0802 


A900 


LDA 


#00 








26 


00 


00 


01 


10 


0C1E 


80 


• command in 


0804 


A005 


LDY 


#05 








24 


00 


00 


05 


10 


2E3C 


80 


effect 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


01 


01 


04 


10 


463B 


00 ! 




080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


03 


02 


03 


10 


3C1C 


80 


TRACE JMP 
■ command in 
effect 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


06 


03 


02 


10 


31FC 


00 


080C 


D0F8 


BNE 


F8 




080C 


0806 


24 


0A 


04 


01 


10 


27DC 


00, 




0807 


7D0005 


ADC 


0500, X 


04 




0504 


24 


OF 


04 


01 


10 


00AD 


00 


BKPT comm 


0807 


BREAK 
























1 


in effect 
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Set a breakpoint after a specific instruction. 

> TRACE ALL <CR> 



> TRACE 



<CR> 



TRACE ALL, ,0000,FFFF 

> BKPT 804 <CR> 

> GO 800 <CR> 



LOC INST 
0800 A200 
0802 A900 
0804 A005 
0804 BREAK 



MNEM OPER X/Y I/PC EADD SR RA RX RY SP TC IOS 

LDX #00 26 OF 00 01 10 21E1 80 

LDA #00 26 00 00 01 10 43FF 80 

LDY #05 24 00 00 05 10 1CD1 80 



Set new values to pass counter and table pointer; check results. 

> SET RX 02 02 <CR> 



new contents of the Y register, 
the pass counter 

new contents of the X register, 
the table pointer 



designates the X register 



> DSTAT 



<CR> 



PC=0806 BP=0504 R 0804 



SR RA RX RY SP TC IOS 
M=0 24 00 02 02 10 3EEF 80 



Y register contents 
(pass counter) 



X register contents 
(table pointer) 
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• Resume program execution, 
> GO <CR> 

LOC INST MNEM OPER X/Y I/PC EADD SR RA RX RY SP TC IOS 



0806 18 


CLC 








24 


00 


02 


02 


10 


1267 80 


0807 7D0005 


ADC 


0500, X 02 




0502 


24 


03 


02 


02 


10 


17C0 80 


080A E8 


INX 








24 


03 


03 


02 


10 


39DE 80 


080B 88 


DEY 








24 


03 


03 


01 


a r\ 

1 u 


12B0 80 


080C D0F8 


BNE 


F8 


080C 


0806 


24 


03 


03 


01 


10 


34CF 80 


0806 18 


CLC 








24 


03 


03 


01 


10 


4830 80 


0807 7D0005 


ADC 


0500, X 03 




0503 


24 


07 


03 


01 


10 


0DA1 80 


080A E8 


INX 








24 


07 


04 


01 


10 


2FC0 80 


080B 88 


DEY 








26 


07 


04 


00 


10 


0892 80 


080C D0F8 


BNE 


F8 


080C 


0806 


26 


07 


04 


00 


10 


2AB0 80 


*D0S« EOJ 























Notice that the program performs two passes through the loop, and that the program adds 
the third and fourth numbers in the table (3 + 4 = 7). 

The program encounters no more breakpoints, so execution is uninterrupted. The *DOS* EOJ 
(End Of Job) message and the prompt character > appear when the service call causes an 
exit to TEKDOS. The service call also takes you out of the Debug system. When you see the 
prompt, the program has finished execution and you may enter your next TEKDOS command. 



Turning Off the 8002A //Processor Lab and Peripherals 

Refer to the Learning Guide, Section 1 of this manual, for a procedure for turning off the 
8002A //Processor Lab and peripherals. 

You have now successfully assembled, loaded, executed, and monitored the execution of the 
Demonstration Run program. The remainder of this subsection contains 6500/1 emulator- 
specific reference material. 
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Emulator-Specific Commands and Displays 

SET— Setting 6500/1 Register Values 

The SET command can be used to change the values in the 6500/1 registers, beginning with 
the first register specified. Use the TEKDOS register designator to name the register in a 
command line. When setting more than one register with a single SET command, set the 
registers in the order in which they're listed below. 



Table 9-23 
6500/1 SET Command Parameters 







TEKDOS 


Register 




Register Designator 


status register 


SR 




accumulator register 


RA 




index register X 


RX 




index register Y 


RY 




stack pointer 


SP 




timer/counter 


TC 




I/O status register 


IOS 





You must invoke the Debug system before you enter a SET command. 

NOTE 
Bits 4 and 5 of the status register cannot be altered with a SET command. 

Example. Suppose the DSTAT command returns the following emulator status: 
> DSTAT 



PC=0000 



SR RA RX RY SP TC IOS 
M=0 24 00 00 00 10 0000 00 



To reassign values to the accumulator, the X register, and the Y register, use the following 
command line. 

> SET RA 98 99 99 
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Since the SET command does not produce a display line, use the DSTAT command to check 
the results of the SET command. 

v no TAT 

/ yoifli 



SR RA RX RY SP TC IOS 
PC=0000 M=0 24 98 99 99 10 0000 00 



m/-i now contains 9u, RX contains 93, and RY contains 93. 



RESET— Resetting 6500/1 Emulator Status 

The RESET command causes the following values to be altered: 

• I/O ports PA, PB, PC, and PD (memory locations 0080, 0081 , 0082, and 0083) are each 
loaded with the value FF. 

• Bit 2 of the status register is set, which disables interrupts. 

• The stack pointer is decremented by three. 

• The I/O status register is cleared. 



DSTAT— Sample 6500/1 Emulator Status Display 

The DSTAT command sends program execution status and breakpoint status to the assigned 
Debug output device or file. All values in the DSTAT display line are hexadecimal. You must 
invoke the Debug system before you enter a DSTAT command. 

This is an example of a DSTAT display line for the 6500/1 emulator: 

> DSTAT 

PC=0807 BP=0504 R 0806 M=0 

The DSTAT display includes: 

PC= the program counter, which contains the address of the next instruction 

to be executed by the emulator; in this example, address 0807. The GO 
command can be used to change the contents of the program counter. 

BP= the breakpoints and breakpoint parameters, if any. In this example, one 

breakpoint is at address 0504, when TEKDOS reads from that address; 
and a second breakpoint is at address 0806, when TEKDOS reads from 
or writes to that address. 

R or W breakpoint parameter: 

R = Break on Read 

W = Break on Write 

Blank = Break on Read or Write 

The BKPT and CLBP commands can be used to change the breakpoint 
status. 
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RA 


RX 


RY 


SP 


TC 


IOS 


24 


00 


02 


03 


10 


3FDA 


AO 
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SR= 

RA= 
RX= 



the emulation mode. In this example, emulation mode 0. The EMULATE 
command can be used to change the emulation mode. 

the contents of the status register. In this example, the status register 
contains 24. The SET command can be used to change this register. See 
Fig. 9-15. 

the contents of the accumulator. In this example, the accumulator 
contains 00. The SET command can be used to change this value. 

the contents of the X register. In this example, the X register contains 
02. The SET command can be used to change this value. 



bit # 7654321 



N 



B 



carry bit 
1=carry set 
zero bit 
' 1=zero result 

interrupt bit 
" 1 interrupt (IRQ) disabled 

decimal mode bit 
' 1 =decimal mode 

break command bit 
' 1=break command 

. unused 

overflow bit 
" 1 =overf low set 

_ negative bit 

' 1=negative value 



3433-1 



Fig. 9-15. 6500/1 Status Register. 

This figure shows the bit configuration for the 6500/1 status register. 



RY= 
SP= 

TO 

IOS= 



the contents of the Y register. In this example, the Y register contains 
03. The SET command can be used to change this value. 

the stack pointer, which contains the memory address of the stack; in 
this example, 10. The contents of the stack pointer can be changed 
using the SET command. 

the contents of the timer/counter. In this example, the timer/counter 
contains 3FDA. The SET command can be used to alter the 
timer/counter. 

the contents of the I/O status register. In this example, the I/O status 
register contains AO. The SET command can be used to change the I/O 
status register. 
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DISM— Sample 6500/1 Disassembled Code 

Use the DISM command to verify that the hexadecimal values in memory correspond to the 



innniigriQ mf»+i-i iMinne Pi! Q ft/I 



I *s nn i io/-w 
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mnemonics, and operands on the assigned Debug output device or file. You must first invoke 
the Debug system in order to enter a DISM command. 

The following is a sample of 6500/1 DISM command output: 

> DEBUG 

> DISM 800 810 



LOG 


INST 


MNEM 


0PER 


0800 


A200 


LDX 


#00 


0802 


A900 


LDA 


#00 


0804 


A005 


LDY 


#05 


0806 


18 


CLC 




0807 


7D0005 


ADC 


0500 


080A 


E8 


INX 




080B 


88 


DEY 




080C 


D0F8 


BNE 


F8 


080E 


8DF704 


STA 


04F7 



address or data being operated on 

symbolic names for the instructions 
hexadecimal machine language instructions 

memory addresses 



TRACE— Sample 6500/1 Trace Display 

The TRACE command lets you monitor program execution. To begin program execution, you 
enter the GO command. When trace conditions have been set, this GO command enables 
TRACE lines to be sent to the assigned Debug output device or file. All values in the TRACE 
display lines are hexadecimal. You must invoke the Debug system before you enter a TRACE 
command. 

Any one of the following conditions will stop both the TRACE display and program execution: 

• you press the space bar to suspend the TRACE display and program execution; 

• you press the ESC key to suspend program execution; 

• the program triggers a breakpoint; 

• the program reaches a Service Call which exits from or aborts the program. 

The TRACE SHORT format on the 6500/1 emulator is the same as the TRACE LONG format. 

NOTE 
The emulator runs slower than normal processing speeds when TRACE 
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The following is an example of 6500/1 TRACE command output: 

> DEBUG 



> TRACE ALL 



> GO 800 



LOC 


INST 


MNEM 


OPER X/ 


0800 


A200 


LDX 


#00 


0802 


A900 


LDA 


#00 


0804 


A005 


LDY 


#05 


0806 


18 


CLC 




0807 


7D0005 


ADC 


0500, X 00 



X/Y I/PC EADD SR RA RX RY SP TC 



IOS 



26 OF 00 01 10 43CC 80 
26 00 00 01 10 1C9E 80 
24 00 00 05 10 3EBC 80 
24 00 00 05 10 178E 80 
0500 24 01 00 05 10 39AD 80 



I/O 
status 
register 



timer/counter 



stack pointer 
Y register 
X register 
accumulator 



status register 

effective address 

contents of indirect 
address or program counter 



X or Y registers for indexed 
instructions 



operand for instruction 
mnemonic for instruction 



hexadecimal representation 
of instruction 



memory address of instruction 
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BKPT— Sample 6500/1 Breakpoint Display 

The BKPT command sets a breakpoint, which suspends program execution when TEKDOS 

inioi iouuj ii^in v/i mnoj tu mo opciiiiieu quuicoo. uivi i ocuuo a uauc unc lu n ic assiyi icu 

Debug output device or file. The GO command resumes program execution after the 
breakpoint. All values in the BKPT display are hexadecimal. You must invoke the Debug 
system before you enter a BKPT command. See the 6500/1 Design Features, elsewhere in 
these 6500/1 Emulator Specifics, for additional information on the BKPT command. 



NOTE 

The emulator runs slightly slower than normal processing speeds when a 
breakpoint has been set. 

The following is an example of 6500/1 BKPT command output: 

> DEBUG 

> BKPT 504 

> GO 800 

L0C INST MNEM 0PER X/Y I/PC EADD SR RA RX RY SP TC I0S 
0807 7D0005 ADC 0500, X 04 0504 24 OF 04 01 10 21AD A0 

0807 BREAK 



The effective address in the trace line is calculated as follows: 

a. For indexed addressing, X/Y contains the contents of either the X or Y register. The 
effective address of the previous instruction is the sum of the register contents and the 
operand. 

b. For relative branch instructions, l/PC contains the contents of the program counter. 
The effective address of the next instruction to be executed is the sum of the program 
counter and the operand. 

c. For indirect instructions, l/PC contains the contents of the indirect address. 
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6500/1 Service Calls 

Service calls (SVCs) allow you to use additional 8002A system capabilities while your 
program is running on the emulator processor. 

TEKDOS allows you to define six different service calls at one time. Each of the SVCs is 
associated with an address and a set of instructions. Any of the following 6500/1 
instructions may be used to generate an SVC: 



ADC 


DEC 


ORA 


AND 


EOR 


ROL 


ASL 


INC 


ROR 


BIT 


LDA 


SBC 


CMP 


LDX 


STA 


CPX 


LDY 


STX 


CPY 


LSR 


STY 



To generate a 6500/1 service call, the instruction must have one of the six SVC addresses in 
its operand field, and must be followed by a NOP instruction to allow time for the SVC to 
occur. 

Table 9-24 lists the code for each 6500/1 SVC. In this table and in the SVC demonstration 
program shown in Fig. 9-16, the STA instruction is used to generate service calls; however, 
any instruction in the above list may be used. 

Table 9-24 
6500/1 Service Calls 



SVC Number 


6500/1 


Service Calls 


SRB Pointer 


1 


STA 
NOP 


04F7H 


40, 41 


2 


STA 
NOP 


04F6H 


42, 43 


3 


STA 
NOP 


04F5H 


44, 45 


4 


STA 
NOP 


04F4H 


46, 47 


5 


STA 
NOP 


04F3H 


48, 49 


6 


STA 
NOP 


04F2H 


4A, 4B 



The operand of the instruction sends TEKDOS to a specific memory address called the SRB 
(Service Request Block) pointer. That specific memory address tells TEKDOS where to find 
the data (stored in the SRB ) that, in turn, tells TEKDOS which service to perform. Section 6 
of this manual explains service calls, service request blocks, and SRB pointers in detail. 
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SVC Demonstration 

Figures 9-16 and 9-17 are an assembler listing of a 6500/1 program that uses four SVC 

funr-tinne' A<5«5inn nhannen Rp»ari ARfMI Writes A^Pli anrl Ahnrt Tho nrnnram'c ainorifhm ie 
. w. .~ . . . , . , ~ . .ww.., «. ■„ . ,„w. ... . . .« K . « a . „■■■ „ „, a ^. . i *, 

explained in Section 6, Service Calls. Section 6 also demonstrates the program, using a 
version of the program written in 8080A assembly language. You can perform a parallel 
demonstration with the 6500/1 emulator using the program in Figs. 9-16 and 9-17. 















ORG 


40H 


;BEGINNING OF SRB VECTOR 






BYTE 


HI(SRB1FN),L0(SRB1FN) 






BYTE 


HI(SRB2FN),L0(SRB2FN) 






BYTE 


HI(SRB3FN),LO(SRB3FN) 






BYTE 


HI ( SRB4FN ) , LO ( SRB4FN ) 






BYTE 


HI(SRB5FN),LO(SRB5FN) 




> 


END OF 


SRB VECTOR 








ORG 


800H 


; SET UP SRB AREAS 




> 


SRB1 = 


ASSIGN "CONI" TO CHANNEL 




SRB1FN 


BYTE 


10H 


ASSIGN 




SRB 1 CH 


BYTE 


00H 


TO CHANNEL 




SRB1ST 


BLOCK 


01H 


STATUS RETURNED HERE 




SRB1BY 


BLOCK 


01H 


RESERVED 




SRB1C0 


BLOCK 


01H 


RESERVED 




SRB1LE 


BYTE 


05H ; 


LENGTH OF "CONI"+<CR> 




SRB1HI 


BYTE 


HI(CONI) ; 


POINTER TO 




SRB1L0 


BYTE 
END OF 


LO(CONI) ; 
SRB1 


"CONI"+<CR> 




> 


SRB2 = 


ASSIGN "LPTT 


TO CHANNEL 1 




SRB2FN 


BYTE 


10H ; 


ASSIGN 




SRB2CH 


BYTE 


01H ; 


TO CHANNEL 1 




SRB2ST 


BLOCK 


01H ; 


STATUS RETURNED HERE 




SRB2BY 


BLOCK 


01H ; 


RESERVED 




SRB2C0 


BLOCK 


01H ; 


RESERVED 




SRB2LE 


BYTE 


05H ; 


LENGTH OF »LPT1"+<CR> 




SRB2HI 


BYTE 


HKLPT1) ; 


POINTER TO 




SRB2L0 

> 


BYTE 
END OF 


L0(LPT1) ; 
SRB2 


"LPT1"+<CR> 




j 


SRB3 = 


READ ASCII L 


INE FROM CONI (CHANNEL 0) 




SRB3FN 


BYTE 


01H ; 


READ ASCII 




SRB3CH 


BYTE 


00H ; 


FROM CHANNEL 




SRB3ST 


BLOCK 


01H ; 


STATUS RETURNED HERE 




SRB3BY 


BLOCK 


01H ; 


RESERVED 




SRB3C0 


BLOCK 


01H ; 


BYTE COUNT RETURNED HERE 




SRB3LE 


BYTE 


00H ; 


256 BYTES IN OUR BUFFER 




SRB3HI 


BYTE 


HI(BUFFER) ; 


POINTER TO 




SRB3L0 
i 


BYTE 
END OF 


LO(BUFFER) ; 
SRB3 


OUR BUFFER 




» 


SRB4 = 


WRITE ASCII 


LINE TO LPT1 (CHANNEL 1) 




SRB4FN 


BYTE 


02H 


; WRITE ASCII 




SRB4CH 


BYTE 


01H 


; TO CHANNEL 1 




SRB4ST 


BLOCK 


01H 


; STATUS RETURNED HERE 




SRB4BY 


BLOCK 


01H 


; RESERVED 




SRB4C0 


BLOCK 


01H 


; BYTE COUNT RETURNED HERE 




SRB4LE 


BLOCK 


01H 


: FILLED IN BY PROGRAM 




SRB4HI 


BYTE 


HI(BUFFER) 


; POINTER TO 




SRB4L0 

> 


BYTE 
END OF 


LO(BUFFER) 
SRB4 


; OUR BUFFER 


3433-2 



Fig. 9-16. 6500/1 SVC Demonstration program (sheet 1 of 2). 
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SRB5FN 
SRB5CH 
SRB5ST 
SRB5BY 
SRB5C0 
SRB5LE 
SRB5HI 
SRB5L0 



BUFFER 
CONI 

LPT1 



START 



SRB5 = ABORT (CLOSE ALL CHANNELS AND TERMINATE) 



LOOP 



ABORT 



BYTE 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 01H 
BLOCK 01H 
BLOCK 01H 
END OF SRB5 



1FH 
01H 
01H 
01H 
01H 



BLOCK 

ASCII 

BYTE 

ASCII 

BYTE 



100H 

"CONI" 

ODH 

"LPT1" 

ODH 



ABORT 

RESERVED 

RESERVED 

RESERVED 

RESERVED 

RESERVED 

RESERVED 

RESERVED 



OUR I/O AREA 
ASCII OF "CONI" 

+ <CR> 
ASCII OF "LPT1" 

+ <CR> 



END OF DATA DEFINITIONS 



BEGINNI 

ORG 

STA 

NOP 

LDA 

CMP 

BNE 

STA 

NOP 

LDA 

CMP 

BNE 

STA 

NOP 

LDA 

CMP 

BNE 

LDA 

STA 

STA 

NOP 

LDA 

CMP 

BEQ 



NG OF EXEC 

OBOOH 

04F7H 

SRB1ST 
#00H 
ABORT 
04F6H 

SRB2ST 
#00H 
ABORT 
04F5H 

SRB3ST 

#00H 

ABORT 

SRB3C0 

SRB4LE 

04F4H 

SRB4ST 

#00H 

LOOP 



STA 04F3H 

NOP 

JMP $ 

END START 



UTABLE CODE 

ENTRY POINT INTO PROGRAM 

CALL SVC1 

TO ASSIGN "CONI" 

CHECK THE STATUS TO SEE 

IF ALL WENT WELL 

NO? STOP EVERYTHING 

YES? CALL SVC 2 

TO ASSIGN "LPT1" 

CHECK THE STATUS TO SEE 

IF ALL WENT WELL 

NO? STOP EVERYTHING 

CALL SVC3 

TO READ A "CONI" LINE 

INTO BUFFER 

ALL OK? 

NO? STOP EVERYTHING 

TRANSFER I/O COUNT 

TO BUFFER LENGTH FOR WRITE 

CALL SVC 4 



CHECK TO SEE IF 

ALL IS OK 

YES? BACK TO READ ANOTHER LINE 

NO? FALL THRU TO TERMINATION 

CALL SVC5 

TO DO THE ABORT 

SHOULD NEVER REACH HERE 

ASSEMBLER DIRECTIVE (ENTRY POINT) 



Fig. 9-17. 6500/1 SVC Demonstration program (sheet 2 of 2). 

This program shows the use of four 8002A service calls. The program's algorithm is explained in 
Section 6 of this manual. Service Calls. You may load this program into 8002A program memory using 
the TEKDOS Editor, the TEKDOS Assembler, and the LOAD command. The program accepts a line of 
ASCII characters from the system terminal; then, after a carriage return, it prints the line on a line 
printer. Terminate the program by entering a CTRL-Z when the program is waiting for input. 
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this figure as you read the following discussion. The 6500/1 can access memory locations 
between 0800 and 0FFF. You may also use locations 0400 to 07FF of 8002A program 
memory when using emulation modes or 1 . Locations 04F0— 04F7, however, are reserved 
for SVC's. 

In addition, locations — 3F and 80 — 8F can be accessed only while operating within the 
Debug system. The following considerations apply: 

• 80, 81, 82, and 83 are I/O Port A, Port B, Port C, and Port D, respectively. 

• 84 — 87 contain the timer/counter. To assign a new value to the timer/ counter, you 
must use the SET command. 

• 88— 8E are not accessible to TEKDOS. 

• 8F contains the I/O status register. To assign a new value to this location use the SET 
command. 



NOTE 

Any attempt to enter the GO command with an address parameter tess than 
400H will cause TEKDOS to display the following error message: 

**«ERR0R 37 INVALID GO ADDRESS 

Programs may be executed in this address range only if the following 
conditions are met: 

• TRACE is off. 

• No breakpoints are set between and 3F. 

• The address is accessed by a microprocessor jump instruction. 
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Fig. 9-18. 6500/1 Memory Allocation. 

Addresses 400H— 7FFH may not be accessed by the 6500/1 microcomputer. However, you may use 
this address range to develop your program on the 8002A. 
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6500/1 Breakpoint Features. 

• A breakpoint placed immediately after a conditional jump instruction will cause a break 
whether the condition is met or not. 

• An unexpected BKPT or RTPA break will occur when all of the following conditions are 
true: 

— The absolute indexed address mode is used with one of the following instructions: 

ADC CMP EOR LDY 

AND CPX LDA ORA 

BIT CPY LDX SBC 

— The effective address (sum of the operand and index register) crosses a page 
boundary. 

— A BKPT or RTPA break is set exactly one page preceding the effective address. 

When all of these conditions are true, a break message is displayed on the line of the 
absolute indexed instruction. 

Clocking the Emulator. The 8002A does not support the resistor-only mask option for 
clocking the 6500/1 emulator in emulation mode 1. 

Edge Detect Capabilities. To use the edge detect capabilities of the 6500/1 microcomputer, 
follow this sequence: 

1. Set PAO and PA1 high by loading 1's in bits and 1 of location SOH. 

2. Clear the edge detect flags by writing to locations 089H and 08AH. You can 
accomplish this by using the STA 089H and STA 08AH instructions. 

3. Enable PAO and PA1 (edge detect interrupt) by setting bits 2 and 3 of the I/O status 
register. Use the SET command to alter the I/O status register. 



Timer/Counter Trace Display. The timer/counter and IOS bit 7 (the timer/counter 
underflow bit) are not accurately displayed in the trace line when operating in Timer Mode 
or 1. 
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Status Register. If you set the zero and negative flag bits of the status register without using 
the BIT instruction, and the TRACE command is active, the following error message will 
appear: 

***SR NOT RESTORED 

The system will then wait for you to change one of these two bits. You can use the SET 
command to accomplish this. To continue, enter the GO command. 



NOTE 

The 6500/1 emulator will not execute properly when the following conditions 
occur simultaneously: 

• The TRACE command is active. 

• Status register bit 3 = 0. 

• The stack pointer is less than or equal to 1 . 
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